home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / clipper / ks94an.zip / WAIT.HDR < prev    next >
Text File  |  1994-04-25  |  1KB  |  44 lines
  1. /******************************************************************************
  2.                  The Klipper Library, for CA-Clipper 5.x
  3.         Copyright (c), 1994, Wallace Information Systems Engineering
  4.  
  5. FUNCTION:
  6.  
  7. _Wait( nSeconds ) --> NIL
  8.  
  9. PARAMETERS:
  10.  
  11. nSeconds : number of seconds to pause program execution
  12.  
  13. SHORT:
  14.  
  15. Pause program execution for nSeconds, regardless of keyboard activity.
  16.  
  17. DESCRIPTION:
  18.  
  19. _Wait() stops program execution much like inkey().  The difference is
  20. that unlike INKEY(), which continues as soon as a key is pressed,
  21. _Wait() waits the number of seconds specified regardless.
  22.  
  23. It is useful where you need to display a message and be sure that no
  24. pending keyboard keystrokes vanish it before it can be read.
  25.  
  26. There is no return value from this function.
  27.  
  28. NOTE:
  29.  
  30. Keyboard input is still buffered while waiting and will be processed as
  31. soon as the wait period is expired.
  32.  
  33. See also: _WaitFor() which stops program execution until one of a set
  34. of specified keys are pressed.
  35.  
  36. EXAMPLE:
  37.  
  38. _Wait(5)
  39.  
  40. Result: Program execution pauses for 5 seconds no matter what the user does
  41. on the keyboard.
  42.  
  43. ******************************************************************************/
  44.